home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d16 / scnpeace.arc / SCRNPEAC.DOC < prev    next >
Text File  |  1990-06-29  |  20KB  |  421 lines
  1.                   Documentation for Screen Peace 1.2
  2.                          by Anthony Andersen
  3.                        Compuserve [72037,2474]
  4.  
  5.                       Program and documentation
  6.                     Copyright 1990 Anthony Andersen
  7.                         
  8.  
  9. [1.0 Introduction]
  10.  
  11.    Screen Peace is a screen saver for Microsoft Windows 3.0. "So what?", you
  12.    say, "I've seen lots of screen savers for Windows." Well... this one is 
  13.    different. Screen Peace by itself is not terribly flashy - it just
  14.    blanks the screen after a certain number of seconds, but it is extensible.
  15.    You can add additional screen savers just by putting more screen saver
  16.    files in the proper directory. If you have the Windows 3.0 SDK, the
  17.    Microsoft C 6.0 compiler and the Screen Peace saver kit, you can make your
  18.    own screen savers.
  19.  
  20.    Screen Peace screen savers are invoked in two ways: 
  21.       1. if you don't a) move the mouse or b) click a mouse button or 
  22.          c) hit a key during a period of time longer than the Saver Delay
  23.          time (default is 300 seconds).
  24.       2. if you move the mouse into the Saver Now Corner (default is the
  25.          upper left corner).
  26.  
  27.    See the configuration options (Section 4) for information on changing
  28.    these values.
  29.  
  30.    Screen Peace picks a saver extension randomly from the saver extensions
  31.    in the Saver Path directory.
  32.  
  33.    Screen Peace 1.2 may be freely distributed with the following three
  34.    conditions:
  35.       1. This file be distributed along with the SAVER.EXE and SAVERDLL.DLL
  36.          files.
  37.       2. No money may be charged for the Screen Peace program.
  38.       3. No more than $7 may be charged for the media it is shipped on.
  39.  
  40.    Screen Peace is CharityWare. Please see the note near the end of this
  41.    file about payment (don't worry, it's a VERY easy payment plan and you
  42.    can feel good about paying for this program). If you paid money to someone
  43.    other than me for a disk containing Screen Peace, you have NOT paid for
  44.    Screen Peace, but for the disk it came on.
  45.  
  46. [1.1 Screen Peace 1.1 additions]
  47.  
  48.    Screen Peace 1.1 will change the Wallpaper bitmap if you specify that it
  49.    should. It randomly picks a bitmap from the directory you specify as the
  50.    Bitmap Directory.
  51.  
  52.    Screen Peace 1.1 shows you which screen saver extensions are enabled. If
  53.    an extension is enabled, you will see a small circle ("degrees" mark - as
  54.    in temperature or portions of an angle) after the name of the saver in the
  55.    "Configure" list box in the Options dialog.
  56.  
  57. [1.2 Screen Peace 1.2 additions]
  58.  
  59.    Lots of bugs fixed!
  60.       1. Saver Now and Saver Never corners should now work properly in
  61.          all cases.
  62.       2. The problem with non-readable disks is fixed (if this happened to
  63.          you, you probably clicked on a floppy drive icon in the program
  64.          manager when there was no disk in the drive). This was a bad
  65.          bug and I apologize for releasing Screen Peace with it there. I
  66.          hope it didn't cause any major problems. The cause, in case you're
  67.          interested was a call to the C library time() function in a bad
  68.          place. Anyway, the DLL is about half its previous size.
  69.       3. The cursor not blanking (which only happened on certain video
  70.          boards) should be fixed. Let me know if you have any more problems
  71.          with this.
  72.  
  73.    Screen Peace now recognizes Windowed DOS boxes in 386 Enhanced mode and
  74.    allows you to choose not to blank the screen when one of the DOS boxes
  75.    is the active window. See the Advanced options in Section 4.2 below.
  76.  
  77.    Screen Peace now realizes a color table if you have a graphics adapter
  78.    with a 256 color driver. This should help several of the savers look 
  79.    better. In case you're interested, it realizes a table similar to the
  80.    Macintosh default color table for 256 color mode. This option can be
  81.    disabled. See the Advanced options Section in 4.2 below.
  82.  
  83.    The Saver Now and Saver Never corners are now 5x5 pixels instead of
  84.    a single pixel.
  85.  
  86.    Screen Peace now supports up to 80 saver extensions. (It also supported
  87.    this number in 1.1 but I neglected to mention it.)
  88.  
  89.    The Options dialog has changed its "look". If you have any suggestions
  90.    regarding the aesthetics of Screen Peace, please let me know.
  91.  
  92.    Even if you were using a previous version of Screen Peace, please read
  93.    this whole document as several things about Screen Peace have changed.
  94.  
  95. [2.0 What you need to run Screen Peace]
  96.  
  97.    1. Microsoft Windows 3.0.
  98.    2. Screen Peace. (you need both SAVER.EXE and SAVERDLL.DLL)
  99.    3. Screen Peace saver extensions. (OPTIONAL - They have a .SPX extension)
  100.  
  101. [3.0 How to run and/or install Screen Peace]
  102.  
  103.    NOTE: All directions below assume that you have a mouse or other pointing
  104.          device. If this is not so, see your Windows manual for the
  105.          appropiate keyboard equivalents.
  106.  
  107.    3.0.0 If you already know how to run Windows applications you can 
  108.       probably skip to the next section.
  109.  
  110.    3.1 Copy SAVER.EXE and SAVERDLL.DLL into your Windows directory
  111.       or another directory on your path. If you don't want to put
  112.       Screen Peace on your path, you will need to include the path
  113.       to SAVER.EXE in each of the following directions. I recommend
  114.       putting Screen Peace in your Windows directory if you are new
  115.       to Windows, it's the easiest way to get things running.
  116.  
  117.    3.2 Do one of the following:
  118.  
  119.         A. (Not a very good choice) Select Run from the Program Manager File
  120.            menu, type SAVER.EXE in the edit field, and click the OK button.
  121.            If you choose this method, you must repeat this every time you
  122.            want to run Screen Peace.
  123.  
  124.         B. (A better choice) Click on one of the program groups in the
  125.            Program Manager and Select New from the Program Manager File
  126.            menu. Make sure the Program Item radio button is checked and
  127.            click the OK button. Type anything in the description edit field
  128.            and type SAVER.EXE in the Command Line edit field. Then click 
  129.            the OK button. Now to run Screen Peace, you only need to double 
  130.            click the Screen Peace icon.
  131.  
  132.         C. (An even better choice) Insert SAVER.EXE in your WIN.INI file on
  133.            either the "load=" or the "run=" line.
  134.  
  135.            example:
  136.                load=SAVER.EXE 
  137.                         or
  138.                run=SAVER.EXE
  139.  
  140.            Just make sure to separate the file names on the line by a space.
  141.            This will load Screen Peace each time you run Windows. By the 
  142.            way, SYSEDIT.EXE is a good program to use for editing the Windows
  143.            system files.
  144.  
  145.            NOTE: This procedure alone will not run Screen Peace until
  146.                  you restart Windows.
  147.  
  148.         D. (The best choice) Do BOTH B. and C.
  149.  
  150.    3.3 Copy any screen saver extensions you may have into a directory named
  151.       C:\SAVER. If you don't want to use the name C:\SAVER, you can change
  152.       the name (referred to as the Saver Path). See the Configuration
  153.       instructions below.
  154.  
  155. [4.0 How to Configure Screen Peace]
  156.  
  157.    4.1 Edit the WIN.INI file - This is the most difficult way to configure
  158.       Screen Peace. I recommend using the Menu and Dialog method described
  159.       in Section 4.2. Screen Peace knows about the following entries in the
  160.       WIN.INI file. Find or create something that looks like this:
  161.  
  162.           [Screen Peace]
  163.           Saver Now Pos=A
  164.           Saver Never Pos=D
  165.           Saver Delay=300
  166.           Saver Path=C:\SAVER
  167.           Saver Enabled=y
  168.           Bmp Change Enab=n
  169.           Bitmap Path=\windows
  170.           Dos Active Disab=n
  171.           Realize Colors=y
  172.  
  173.       Each of the values in the above example is set to the default value.
  174.  
  175.       The "Saver Now Pos" entry tells where the Saver Now Corner is located.
  176.       The "Saver Never Pos" entry tells where the Saver Never Corner is
  177.       located. For these entries:
  178.  
  179.           A = Upper Left
  180.           B = Upper Right
  181.           C = Lower Left
  182.           D = Lower Right
  183.  
  184.       The "Saver Delay" entry is the number of seconds the mouse and keyboard
  185.       must be idle before a screen saver is started.
  186.  
  187.       The "Saver Path" entry is the path to the screen saver extension files.
  188.  
  189.       The "Saver Enabled" entry tells whether Screen Peace is enabled. 'y'
  190.       means Screen Peace is enabled and anything else means Screen Peace is
  191.       disabled.
  192.  
  193.       The "Bmp Change Enab" entry tells whether Screen Peace should change
  194.       the Wallpaper Bitmap. 'y' means Screen Peace should randomly pick a
  195.       bitmap file from the directory specified in the "Bitmap Path" entry.
  196.       Anything else means Screen Peace should not mess with the Wallpaper
  197.       value in the WIN.INI file.
  198.  
  199.       The "Bitmap Path" entry tells Screen Peace where to look for bitmap
  200.       (.BMP) files when changing the wallpaper bitmap.
  201.  
  202.       The "Dos Active Disab" entry tells Screen Peace where it should stop
  203.       blanking the screen if a DOS box is the active window. A 'y' means
  204.       don't ever blank the screen if a DOS box is active and anything else
  205.       means blank the screen normally.
  206.  
  207.       The "Realize Colors" entry is only applicable to those who have 256
  208.       color video drivers. A 'y' means realize a set of 256 colors for the
  209.       saver programs to use and anything else means use the default 16 
  210.       colors. If you don't have a 256 color video driver, you should ignore
  211.       this field.
  212.  
  213.       If you have screen saver extensions, there may be other fields. For my
  214.       own savers, there will be at least one entry similar to:
  215.  
  216.           Sticks On=y
  217.  
  218.       where 'y' means the saver is enabled and 'n' means the saver will never
  219.       be used.
  220.  
  221.       NOTES: changes made in the WIN.INI file will not take effect until
  222.              you restart Windows.
  223.  
  224.    4.2 The Menu and Dialog Way - Click on the Screen Peace icon. You will
  225.       get a menu with the following items:
  226.  
  227.         Move
  228.         Close
  229.         Switch To...
  230.         Corners
  231.         Options...
  232.         Advanced...
  233.         About...
  234.  
  235.       The Move item is used to move the Screen Peace icon. See the Windows
  236.       documentation for more information.
  237.  
  238.       The Close item is used to quit Screen Peace. See the Windows
  239.       documentation for more information.
  240.  
  241.       The Switch To... item is used to switch to another application. See the
  242.       Windows documentation for more information.
  243.  
  244.       The Corners item is used to choose the Saver Now Corner and the Saver
  245.           Never Corner. When the mouse pointer is in the Saver Now corner,
  246.           Screen Peace invokes a screen saver after a one to two second
  247.           delay. When the mouse pointer is in the Saver Never corner, Screen
  248.           Peace never invokes a screen saver.
  249.  
  250.       The Options... item is used to set the Saver Delay Time, set the Saver
  251.           Path, and configure screen savers individually. The following 
  252.           describes the Options dialog box.
  253.  
  254.           Below the copyright line is a check box marked "Saver Enabled". If
  255.           the box is checked (X'ed), Screen Peace is enabled. Otherwise it
  256.           will not function. By default, Screen Peace is enabled.
  257.  
  258.           Below the check box is an edit field marked "Delay in Seconds".
  259.           Type the number of seconds you want Screen Peace to wait for a
  260.           mouse or key message before blanking the screen. By default, Screen
  261.           Peace waits 300 seconds.
  262.           
  263.           Below the first edit field is another edit field marked "Saver
  264.           Path". Type the name of the directory you want Screen Peace to 
  265.           search for screen saver extensions in this field. By default,
  266.           Screen Peace searches a directory called C:\SAVER.
  267.  
  268.           Below the second edit is a list box marked Configure. This 
  269.           contains the names of all the screen savers Screen Peace could
  270.           find. Double click on the name of a screen saver and you can 
  271.           set its configuration.
  272.  
  273.           Below the list box is a check box marked "Bitmap Changer Enabled".
  274.           If the box is checked, the bitmap changer is enabled. By default,
  275.           the bitmap changer is disabled.
  276.  
  277.           Below the second check box is an edit field marked "Bitmap Path".
  278.           Type the name of the directory you want Screen Peace to search for
  279.           bitmap files in this field. By default, Screen Peace searches the
  280.           \WINDOWS directory.
  281.  
  282.       The Advanced... item is used to set advanced options.
  283.  
  284.           If you check the "Active DOS box disables Screen Peace" box, Screen
  285.           Peace will not activate when a Windowed DOS box is the active
  286.           window. The default state of this check box is disabled. You can
  287.           invoke a saver by moving the mouse pointer to the Saver Now corner
  288.           in any case. This should only be needed by people running Windows
  289.           in the 386 Enhanced mode.
  290.  
  291.           (If you do not have a 256 color graphics adapter, the "Realize
  292.           color table" section will not affect you.) If you check the
  293.           "Realize color table" box, and you have a video driver which
  294.           supports 256 colors (SuperVGA, 8514a, etc.), a 256 color table will
  295.           be realized for the saver window. Currently, some of the extensions
  296.           recognize the additional colors and some do not. In particular,
  297.           Sticks, Blocks, and Kaleidoscope need the realized color table or
  298.           many of the colors they choose will be black. The default state of
  299.           this check box is enabled. For those of you working on your own
  300.           savers, please get a copy of the updated Screen Peace developers
  301.           kit.
  302.  
  303.       The About... item is used to get information about the programmer.
  304.  
  305. [5.0 How to preview screen savers]
  306.  
  307.    1. Select Options... from the system menu.
  308.    2. Hilight the name of the saver you want to preview in the list box.
  309.    3. Move the mouse into the Saver Now Corner or wait for Screen Peace
  310.       to time out.
  311.  
  312.    After the previous three steps, the saver you have hilighted will be
  313.    started. Sorry, but there is no way to do this without a mouse except
  314.    to wait for the saver to time out.
  315.  
  316. [6.0 How to get in touch with me]
  317.  
  318.    1. Write to:
  319.  
  320.        Anthony Andersen
  321.        1211 S. Quebec Wy #3-108
  322.        Denver, CO  80231
  323.  
  324.    2. Send Compuserve mail to:
  325.  
  326.        [72037,2474]
  327.  
  328.    3. Send mail on a BBS to:
  329.  
  330.        User # /496 - Magnum BBS     (805)582-9306
  331.        User # /74  - OS/2 Mag BBS   (805)684-0589
  332.  
  333. [7.0 How to create screen saver extensions]
  334.  
  335.    Get the file SPEXTN.ZIP from the MSWIN forum on Compuserve or send me
  336.    $5 and I'll send you a disk (please specify format). The zip will include
  337.    the info you need and at least one example saver (STICKS). You must have
  338.    the Windows 3.0 SDK and Microsoft C 6.0 to write saver extensions.
  339.  
  340. [8.0 How to pay for Screen Peace]
  341.  
  342.    Screen Peace is CharityWare. A donation of whatever you think appropriate
  343.    (I think $5 or $10 is what the others are charging) can be sent to the
  344.    above address to make your copy of Screen Peace legal.
  345.  
  346.    ALL PROFITS (UNLESS SPECIFICALLY REQUESTED OTHERWISE) WILL GO TO SUPPORT
  347.    GREEN PEACE, IN MY OPINION A VERY WORTHY CAUSE.
  348.  
  349.    If you don't wish to support Green Peace, specify which other charitable
  350.    organization you wish your contribution to go to (an address would help).
  351.    If you wish to make the contribution yourself, go ahead but PLEASE send
  352.    me a letter or message telling me about it. I would really appreciate it.
  353.  
  354.    I hate to do this, but supporting Screen Peace has already been very 
  355.    expensive so I am asking for a VOLUNTARY contribution of $2 to help
  356.    pay my Compuserve bill (I've spent about 10 hours on Compuserve in the
  357.    last five days). If you do not wish to make this contribution, please do
  358.    not feel obligated to do so, but I will have to stop logging on to CIS
  359.    every day and answering every message unless I can find a way to defray
  360.    some of the expense. Any excess money collected WILL go to support Green
  361.    Peace. Please make a note with your payment if you wish to contribute to
  362.    the "Anthony Andersen Screen Peace Support CIS Fund" (or AASPSCISF).
  363.  
  364. [9.0 Other notes]
  365.  
  366.    9.1 If you want additional screen savers, I (and hopefully others) will be 
  367.    uploading them to the MSWIN forum on Compuserve. If you want them on disk,
  368.    send me $5 and I'll ship you a disk (please specify format) of no less
  369.    than 10 savers. I would appreciate a copy of any savers you write.
  370.  
  371.    9.2 Many thanks go to John Ridges (author of the DESKPIC screen saver for
  372.    OS/2 and a really great guy) for the FLEX screen saver and to Keith Agee 
  373.    (another really great guy) for the KALEIDOSCOPE and BLOCKS screen savers.
  374.    Thanks also to both of them for help with testing Screen Peace.
  375.  
  376.    9.3 Updates will be posted on Compuserve. If you want to be sure to get 
  377.    updates, send an extra $5 and your disk format and I will mail you a copy
  378.    of the next version with as many savers as I can fit on the disk.
  379.  
  380.    9.4 About BITMAP.SPX. If you put a Windows 3.0 device independent bitmap
  381.    file or an OS/2 1.x bitmap file (.BMP) in your screen savers directory and
  382.    name it BITMAP.BMP, BITMAP.SPX will use that bitmap instead of the normal
  383.    Screen Peace bitmap.
  384.  
  385.    9.5 Password protection may be added to Screen Peace. I personally don't
  386.    like it, but if I get enough requests for it, I will try to add it (it is
  387.    kind of a nasty problem given the screen saver extension interface). So
  388.    far, I've only had one request from several hundred messages.
  389.  
  390.    9.5 In certain cases, not all the savers you have in your directory will
  391.    show up in the "Configure..." listbox in the Options dialog. This happens
  392.    when you are running a Windows application with the same root name as one
  393.    of the screen savers (example: when CLOCK.EXE is running, CLOCK.SPX will
  394.    not show up in the list box). This is a problem with Windows not being
  395.    able to load both an EXE and a DLL with the same root name. 
  396.  
  397.    9.5.1 It is also possible that you could start an EXE with the Options
  398.    dialog box up. In this case, any saver with the same root filename whose
  399.    name is in the list box will not function and the default screen saver
  400.    (just blanks the screen) will run instead. This only happens in saver
  401.    preview cases (see Section 7.0 above).
  402.  
  403.    9.6 Please note that if you choose the "Active DOS box disables Screen
  404.    Peace" Advanced Option, Screen Peace will be disabled ANY time a DOS box
  405.    is active INCLUDING when the DOS box is iconized. Moving the mouse pointer
  406.    into the Saver Now Corner overrides this limitation.
  407.  
  408.    9.7 Due to an incredible number of messages I have to ask the following:
  409.    Please look for information on Screen Peace in the message section
  410.    of the MSWIN forum on Compuserve before sending me mail about any problems.
  411.    If you're having a problem, it is likely that someone else has had the
  412.    same problem and the answer is on the board. This will save me time and
  413.    allow me to get busy writing LOTS of extensions for Screen Peace. Do not
  414.    feel that I don't want to hear from you! If you have any comments or
  415.    suggestions or problems (I hope the problems are about all solved), I
  416.    would love to hear from you. I will be posting messages describing updates
  417.    and problem workarounds under the topic "Screen Peace".
  418.  
  419.    9.8 Many thanks are due to Morrie Wilson for help in correcting the bugs
  420.    in previous versions.
  421.